<!DOCTYPE HTML>
<html>
<head>
<title>ListLines | AutoHotkey</title>
<meta name="description" content="The ListLines command displays the script lines most recently executed." />
<meta http-equiv="content-type" content="text/html; charset=utf-8">
<meta http-equiv="X-UA-Compatible" content="IE=edge">
<link href="../static/theme.css" rel="stylesheet" type="text/css" />
<script src="../static/content.js" type="text/javascript"></script>
</head>
<body>

<h1>ListLines</h1>

<p>显示最近执行的脚本行.</p>

<pre class="Syntax"><span class="func">ListLines</span> <span class="optional">, OnOff</span></pre>
<h2 id="Parameters">参数</h2>
<dl>

  <dt>OnOff</dt>
  <dd><p>如果为空或省略, 则显示最近执行的脚本行的历史. <span class="ver">[v1.0.48.01+]</span>: 添加了可选的首个参数, 可以为 On 或 Off. 它只影响<a href="../misc/Threads.htm">当前线程</a>的行为, 说明如下:</p>
      <p><strong>On</strong>: 包括历史中后续执行的行. 对于所有的脚本这是初始默认值.</p>
      <p><strong>Off</strong>: 在历史中略去后续执行的行.</p>
      <p><span class="ver">[v1.1.30+]:</span> 可以分别使用十进制值 1 和 0 代替 On 和 Off.</p>
</dd>

</dl>

<h2 id="Remarks">备注</h2>
<p>ListLines(不带参数) 等同于在主窗口中选择了 "View-&gt;Lines most recently executed" 菜单项. 可用于<a href="../Scripts.htm#debug">调试脚本</a>.</p>
<p><code>ListLines Off/On</code> 可用来选择性的从历史中略去一些行, 这样有助于避免历史被过快填满(例如在含许多快速重复的循环中). <code>ListLines Off</code> 还可以提升一些脚本的性能.</p>
<p>每个新运行的<a href="../misc/Threads.htm">线程</a>(例如 <a href="../Hotkeys.htm">热键</a>, <a href="Menu.htm">自定义菜单项</a>或<a href="SetTimer.htm">定时</a>子程序) 都会以此命令的默认设置开始. 通过在脚本的自动执行段(脚本的顶部) 使用此命令可以改变这个默认设置.</p>
<p><span class="ver">[v1.1.28+]:</span> 如果启用了 ListLines, 则内置变量 A_ListLines 将包含 1, 否则包含 0.</p>
<p><span class="ver">[v1.1.28] 之前的版本:</span> 尽管没有内置变量 "A_ListLines", 但在脚本中使用下列语句可以实现相同的功能:</p>
<pre>ListLines(PassTrueToTurnOnOrFalseToTurnOff)  <em>; 返回 ListLines 之前的设置 (在此调用之前).</em>
{
    static sListLines := true  <em>; 对于所有的脚本的初始默认设置为 "ListLines On".</em>
    ListLines % PassTrueToTurnOnOrFalseToTurnOff ? "On" : "Off"  <em>; 无条件执行 ListLines 来略去日志还未执行的行.</em>
    ListLines_prev := sListLines
    sListLines := PassTrueToTurnOnOrFalseToTurnOff
    return ListLines_prev
}

<em>; 使用上面的函数:</em>
prev_ListLines := ListLines(false)  <em>; 临时关闭 ListLines.
; ...</em>
ListLines(prev_ListLines)  <em>; 恢复 ListLines 到原来的设置.</em></pre>
<p>相关提示, 内置变量 <a href="../Variables.htm#LineNumber">A_LineNumber</a> 和 <a href="../Variables.htm#LineFile">A_LineFile</a> 分别包含当前执行的行的编号和所属文件名.</p>
<h2 id="Related">相关</h2>
<p><a href="KeyHistory.htm">KeyHistory</a>, <a href="ListHotkeys.htm">ListHotkeys</a>, <a href="ListVars.htm">ListVars</a></p>
<h2 id="Examples">示例</h2>
<div class="ex" id="ExBasic">
<p><a class="ex_number" href="#ExBasic"></a> 显示最近执行的脚本行.</p>
<pre>ListLines</pre>
</div>

<div class="ex" id="ExOff">
<p><a class="ex_number" href="#ExOff"></a> 从历史记录中省略随后执行的脚本行.</p>
<pre>ListLines Off</pre>
</div>

</body>
</html>